Image Setup

Purpose: This topic describes how to set up images to display in CWSerenade.

You can set up the following types of images:

• a company logo to display at menu screens: see Setting Up Company Logos for Menu Screens

• an image to display in the right-hand area of the menu driver screen for users who do not have authority to view Open, Held Order Recap Dollars and Order Statistics; see Setting Up Menu Driver Images for Companies

• a company logo to print on forms: see Setting Up Company Logos for Forms

• an entity logo to print on selected forms: see Setting Up Entity Logos for Pick Slips

• an item depiction to display in order entry, at the Work with Item Information screen, and at the Work with Item screen: see Setting Up Item Images

Setting Up Company Logos for Menu Screens

Purpose: You can set up a company logo for each company within CWSerenade to display at menu screens. To set up company logos for menu screens:

• Image size: The company image for menus should be 270 pixels wide by 240 pixels high.

• Image location: C:\Serenade\server\webapps\ROOT\Pics on the CWSerenade server, where C: is the root drive.

• Image naming convention: The company logo image file name for menus should consist of:

• the label MenuLogo and the zero-padded company number if you would like to display individual company-specific logos

• the .JPG extension

Example: The logo image file for company 6 should be named MenuLogo006.jpg.

If there is no image file for the user’s current company, CWSerenade displays the default logo delivered with the application.

If the company logo does not display correctly:

• If you add, change, or delete the company image for menus, menu screens in CWSerenade might not display the change immediately because the image might be cached on your local computer. To display the current company image for menus, exit CWSerenade and clear the cache in your browser.

• Image files should not exceed 10K in size.

Setting Up Menu Driver Images for Companies

Purpose: You can set up a menu driver image for each company within CWSerenade to display in the right-hand area of menu screens for users who do not have authority to view the Open, Held Order Recap Dollars and Order Statistics. The Display Order Statistics and Recap (J03) secured feature controls the authority to view these components. To set up menu driver images:

• Image size: The menu driver image should be 400 pixels wide by 420 pixels high.

• Image location: C:\Serenade\server\webapps\ROOT\Pics on the CWSerenade server, where C: is the root drive.

• Image naming convention: The menu driver image file name should consist of:

• the label MenuDriverLogo and the zero-padded company number

• the .JPG extension

Example: The menu driver image file for company 6 should be named MenuDriverLogo006.jpg.

If there is no menu driver image file for the user’s current company, this area on the menu driver screen is blank. You cannot set up a default image that is not specific to a company.

For more information: See the Menu Driver Screen.

Setting Up Company Logos for Forms

Purpose: If you use a standard graphical print program for a form, you can point to an image of your company logo to include on the form. The image must be in .JPG format, and:

• Image size:

• The company logo image for the purchase order should be 210 pixels wide by 70 pixels high.

• The company logo image for the gift certificate and merchandise credit should be 50 pixels wide by 180 pixels high.

• All other company logo images for forms, including the pick slip image should be 239 pixels wide by 80 pixels high. The pick slip image is also used on several other forms, listed below.

• Image location: Save each company logo image file in the reports\Jasper reports\images folder under the cwdirectcp.properties folder. The cwdirectcp.properties file is typically located at C:\Serenade\server\conf\cwdirectcpproperties where C: is the root drive; so the images should be located at C:\Server\server\conf\cwdirectcpproperties\reports\Jasper Reports\images.

• Image naming convention: The company logo image file name should consist of the name of the print program for the form, the label CompanyLogo, and the company number, plus the .JPG extension. For example, the logo image file for pick slips in company 6 should be named PICKCompanyLogo6.jpg.

• Pick image used on other forms: You do not have to create a separate company logo image to print on the following forms, which use the logo image for the pick slip:

• Quote FormDrop Ship Pick Slip/Invoice

• Order Summary

• Pack Slip

• Order Receipt

For each of these forms, the system uses the image file created for the pick slip (for example, PICKCompanyLogo1.jpg (company logo, where 1 is the company code) or the PICKEntityLogo177.jpg (entity logo, where 1 is the company code and 77 is the entity if the Print Entity Image (K35) system control value is selected. See Setting Up Entity Logos for Pick Slips for details.

• Image naming for unique forms: Even if you use a custom printing program, it is not necessary to include the complete print program in the image name. For example, if your unique pick printing program is PICKABC rather than PICK, you can still use a name of PICKCompanyLogo6.jpg.

Note: Image files should not exceed 10K in size.

For more information: See Forms Management (My Forms) for additional background and setup requirements for forms, such as related system control values.

Restart the application: To be sure that changes to form images take effect, you can restart the application. See Restarting CWSerenade for more information.

Setting Up Entity Logos for Pick Slips

Purpose: Optionally, you can print the entity logo rather than the company logo on pick slips and certain other documents.

Select the Print Entity Image (K35) system control value if you want to always use the entity logo on pick slips and certain other documents. This setting requires that you set:

• the outbound version of the PICK_OUT job in Working with Integration Layer Processes (IJCT) to 2.0 or higher, and

• the Pick Printing Program (C37) system control value to PICKG, or to a unique graphical print program that supports printing the entity logo.

Note: If you select the Print Entity Image (K35) system control value, then the pick slip will never print a company logo, so it is important to set up an entity logo for each entity in your company that might generate pick slips. If there is no logo for an entity, the logo area on the pick slip will be blank.

Generating pick slips: When you generate pick slips, the job includes pick slips of different entities within the same .PDF file. See Performing Pick Slip Generation for background.

Setup requirements: The entity logo image file name should consist of the label PICKEntityLogo, the company number, the entity number, plus the .JPG extension.

Note: The company number and the entity number are not zero-filled. For example, the logo for company 6, entity 10 is PICKEntityLogo610.jpg.

Image size and location: The image should be the same dimensions as the company logo, and stored in the same folder on the server. See Setting Up Company Logos for Forms, above, for details.

Other printing programs:

• Drop ship pick slip: Includes the entity logo if the Print Entity Image (K35) system control value is selected and the Drop Ship Pick Print Program (E92) system control value is set to PICKG.

• Order summary: Includes the entity logo if the Print Entity Image (K35) system control value is selected and the Order Summary Print Program (K31) is set to ORDERSUMG.

• Pack slip: Includes the entity logo if the Print Entity Image (K35) system control value is selected and the Pack Slip Print Program (K32) is set to PICKPACKG.

• Quote form: Includes the entity logo if the Print Entity Image (K35) system control value is selected and the Quote Printing Program (K73) system control value is set to QUOTEG.

• Order receipt: Includes the entity logo if the Print Entity Image (K35) system control value is selected and the Order Receipt Print Program (L46) is set to ORDERRECG

Note: The gift acknowledgement does not use the entity logo regardless of the setting of the Print Entity Image (K35) system control value.

Setting Up Item Images

Purpose: Certain screens in order entry, order maintenance, and item maintenance display an item image if one is configured for the item.

Location of images: The setting of the Use External Item Image (L55) system control value defines whether you store item images on the CWSerenade application server or on an external image hosting application.

• Selected = Item images are stored on an external image hosting application. See Item Image/Info Link Screent for and overview and instructions on setting up remote item images.

• Unselected = Item images are stored on the CWSerenade application server. See below for instructions on setting up local item images.

Setting Up Item Images on the CWSerenade Application Server

Displaying the item image:

• Work with Order Lines Screen (Adding Items to the Order): This screen displays the image for each item after you enter the item, and the image of the last item entered remains on this screen until you exit. If an image is not defined for an item, no image displays.

You can click on the item image to advance to the Work with Item Information Screen (Customer Service Template).

• Work with Item Information Screen: This screen displays the image for the item. If an image is not defined for an item, no image displays.

• Work with Items Screen (MITM): This screen displays the image defined for the item when you mouse over the item code. If an image is not defined for the item, the default image displays.

Default image: If there is no image available for an item:

• The Work with Order Lines screen and Work with Item Information screen do not display a default image.

• The Work with Items screen displays the image defined for the default_popup.jpg file located at C:\Serenade\server\webapps\ROOT\Pics, where C:\ is the root drive of the CWSerenade server. The delivered default image is a very small white box so that it appears that no image displays when an image is not available for an item. However, you can change the image for the default_popup.jpg file to fit your needs.

About the item image:

• base item level: CWSerenade displays a single image for an item, even if the item has SKUs. If you would like to indicate SKU variations (for example, different colors available), you can incorporate these variations into the item image.

• image name: CWSerenade identifies the image to display based on the file name that matches the item name. For example, if there is an image file named ABC123.jpg, CWSerenade displays this image for the item ABC123. If ABC123 is a SKUed item, CWSerenade displays ABC123.jpg for each SKU.

• image size: The image is displayed at 150 x 150 pixels at the Work with Order Lines Screen (Adding Items to the Order), and at 120 x 120 pixels at the Work with Item Information Screen and the Work with Items Screen in item maintenance. For best results, size your item images to 150 x 150 pixels.

• image path: CWSerenade looks for item images in C:\Serenade\server\webapps\ROOT\Pics, where C:\ is the root drive of the CWSerenade server.

Troubleshooting item images:

• The file name must be uppercase, and the .JPG extension must be lowercase: for example, ABC123.jpg, not abc123.jpg or ABC123.JPG.

• Image files should not exceed 10K in size.

• The image name is not company-specific. If you have an item named ABC123 in both company 1 and company 2, CWSerenade displays the same image in both companies.

• In order to display the Work with Item Information screen, you need to first assign the item to an item class, and set up the Customer Service template for the item class. Use Work with Item Class (WICL) to set up item classes and templates.